home *** CD-ROM | disk | FTP | other *** search
/ Hobby PC 18 / Hobby PC 18.iso / Soft / cp2setup / cptech.tx_ / cptech.tx
Text File  |  1998-07-13  |  15KB  |  353 lines

  1. CYPET TECHNICAL INFORMATION for CyPet v2.0            (c) Axe Software 1997-1998
  2. by Alex Warren, July 1998
  3.  
  4.  
  5.  
  6. This text file contains information on the .CYP file format, registry
  7. entries used by CyPet, the cheat, and how to change the graphics.
  8.  
  9. Axe Software will *not* accept responsibility for any damage you do while
  10. following any instructions given. Axe Software cannot guarantee the reliability
  11. of the information presented here.
  12.  
  13. Note that if you put out-of-range values into the .CYP file it is quite
  14. possible the pet will not load at all and/or you will get some strange
  15. errors. If you put out-of-range values into the CyPet section of the
  16. registry it is quite likely CyPet will not work at all, or will behave
  17. very strangely.
  18.  
  19. Again, Axe Software **WILL NOT** accept responsibility for any damage you
  20. cause as a result of using the information contained within this file.
  21.  
  22.  
  23. THE FILE FORMAT
  24.  
  25. Files for CyPet as saved with a .CYP extension and the format is
  26. actually very simple and therefore easy to edit. The files are saved as
  27. text files in the format below. Items in <brackets> refer to numbers, eg
  28. <happiness (0 to 10)> would be a number between 0 and 10. Items in
  29. [square brackets] refer to strings.
  30.  
  31.  
  32. LINE #  TEXT                    COMMENT
  33.      1  CYPET02                 Version header. If the text in this line
  34.                                 is different, CyPet will not read the
  35.                                 file. The exception is when the version header
  36.                                 is CYPET00 - in this case, CyPet 2 knows that
  37.                                 the file was saved in CyPet 1 and will load
  38.                                 the pet and assume as Strength value of 5.
  39.                                 CYPET01 is the header used in the original Beta
  40.                                 Release 1. This was upgraded in Beta Release 1a
  41.                                 to fix a bug where some information was not
  42.                                 saved properly. CyPet should be able to load a
  43.                                 file with a CYPET01 header, though this has not
  44.                                 been tested.
  45.  
  46.      2  <hunger (-10 to 10)>    Hunger value, -10 being full-up and 10
  47.                                 being on the verge of death.
  48.                                 
  49.      3  <weight (0+)>           Weight of the pet. The ideal weight for 
  50.                                 a pet is (age+1)*10
  51.                                 
  52.      4  <happiness (0 to 10)>   Happiness value, 0 being suicidal and 10
  53.                                 being totally ecstatic.
  54.                                 
  55.      5  <boredom (0 to 10)>     Boredom value, 0 being interested in
  56.                                 everything around and 10 being utterly
  57.                                 bored out of its brains.
  58.                                 
  59.      6  <health (0 to 10)>      Health value, 0 being on death's door
  60.                                 10 being as healthy as can be.
  61.                                 
  62.      7  <dirtiness (0 to 10)>   Dirtiness value, 0 being clean and 10
  63.                                 being a pretty disgusting mess.
  64.                                 
  65.      8  <age (0+)>              Age
  66.      
  67.      9  <discipline (0 to 10)>  How much discipline the pet is being
  68.                                 given. This can be altered from the
  69.                                 discipline window so there's not much
  70.                                 point in editing it.
  71.                                 
  72.     10  <behaviour (0 to 10)>   Behaviour value, 0 being an evil git and
  73.                                 10 being "teacher's pet" (witty pun
  74.                                 there)
  75.                                 
  76.     11  [name]                  Pet's name. This can be altered using
  77.                                 Change Name function in the Stats screen
  78.                                 so again, there's not much point editing
  79.                                 this line.
  80.                                 
  81.     12  <strength (0 to 10)>    Strength value of the pet, set on the New
  82.                                 Pet dialog. This value is not included when
  83.                                 the version header is CYPET00 - ie a file
  84.                                 saved in CyPet v1.0.
  85.                                 
  86.     13  <pet type (0+)>         A number to identify which animal the pet is.
  87.                     This will refer to a position in the
  88.                     ANIMALS.DAT file - the first pet defined is 1,
  89.                     the second 2, etc.
  90.  
  91.  
  92. So, here is an example file:
  93.  
  94. CYPET01
  95.  0.01 
  96.  10 
  97.  5 
  98.  0.01 
  99.  9.95246523618698 
  100.  0.01 
  101.  0.001 
  102.  0 
  103.  8.13642084598541 
  104. Henry
  105.  5
  106.  1
  107.  
  108.  
  109. Here, the pet "Henry" is neither hungry nor full up, is a good weight, is
  110. reasonably happy, not bored at all, very healthy, not dirty, very young,
  111. undisciplined and very well-behaved. It has average strength and is of type 1.
  112.  
  113. The health and behaviour values fluctuate randomly, so that is why in the above
  114. example the numbers have a lot of decimal places.
  115.  
  116.  
  117. REGISTRY
  118.  
  119. You don't really need to use the registry to change anything as you can
  120. do all the changes right from the CyPet program. But, for the curious,
  121. here is how to edit the settings:
  122.  
  123. Run REGEDIT (click Start|Run, type REGEDIT and press ENTER, or make a
  124. shortcut to REGEDIT.EXE somewhere). Then go to:
  125.  
  126. HKEY_CURRENT_USER\Software\VB and VBA Program Settings\CyPet\
  127.  
  128. You will see there are three sub-folders:
  129.     Data
  130.     Init
  131.     Options
  132.     
  133. To edit any of the values in these folders, double-click the folder and
  134. then double-click the entry you want to edit. Enter the new value in the
  135. "Value Data" box and press ENTER.
  136.  
  137. The sub-folders contain the following entries - note that you may have less as
  138. some settings may be left-overs from CyPet 1:
  139.  
  140. SUB-FOLDER  ENTRY           COMMENT
  141.  
  142. Data        bestage         Highest age of any pet
  143.             bestperson      Person who scored the highest age
  144. Init        install         Value CyPet uses to see if it exists.
  145.                             Anything other than 0 will make CyPet
  146.                             restore any missing entries in the registry
  147.                             next time it starts. It will also bring up
  148.                             the "read CYPET.TXT" message that you saw
  149.                             when you first used CyPet. NOTE: Setting
  150.                             this to anything other than 0 will NOT make
  151.                             CyPet restore any invalid entries in the
  152.                             registry - it will only resotre MISSING
  153.                             entries. [NOTE: This is a value from CyPet 1. I'm
  154.                             not sure if it is used in CyPet 2... which is odd,
  155.                             since I programmed it :) ]
  156.             version         Version identifier. If set to anything other than 
  157.                             "200IB3", CyPet will restore missing values in the
  158.                             registry. In version 1.0, this value was "100", so
  159.                             when you upgrade from CyPet 1 to CyPet 2, CyPet
  160.                             keeps the original settings.
  161.             cypetlocation   The location of CyPet. This was only used in CyPet
  162.             1 and is definitely NOT used in CyPet 2, so it is
  163.             more than likely you will not have it on your
  164.             system. CyPet 2 reads the location automatically.
  165.             licenseename    Your name that you entered when you first ran
  166.                             CyPet.                
  167.             serialnumber    Your serial number.
  168. Options     autobringup     This number actually stores two pieces of
  169.                             information. Convert it into binary to get
  170.                             the two bits. The first bit is the
  171.                             autobringup for the stats window, 1 making
  172.                             the window come up. The second bit is the
  173.                             autobringup for the discipline window. So,
  174.                             to bring up both windows the bits would be
  175.                             11, converting to the decimal number 3.
  176.             prompting       Specifies prompting method:
  177.                                 1 - Automatic saving
  178.                                 2 - Prompt to save
  179.                                 3 - No prompting
  180.             startupfilename The file to load when CyPet starts.
  181.             startupmode     Specifies what to do on startup:
  182.                                 0 - Do nothing
  183.                                 1 - Load file in startupfile
  184.                                 2 - Use last loaded file, saved in
  185.                                     startupfile
  186.                                 3 - Prompt to load file
  187.                                 4 - Start with new pet
  188.             timerinterval   Timer Interval in milliseconds, eg 1 second
  189.                             = 1000
  190.             warningmode     Convert to binary to read three bits.
  191.                             Bit 1 - Pop up message
  192.                             Bit 2 - Warn in status bar
  193.                             Bit 3 - Warn as bold label in Stats
  194.             bosswait        Specifies the amount of time to wait after the
  195.                             boss key has been pressed, in seconds.
  196.             showtoolbar     "True" or "False", specifies whether the
  197.                             toolbar is displayed
  198.             playsounds      "True" or "False", specifies whether sounds are
  199.                             played
  200.             soundinterval   The chance of a random sound, i.e. 1 in
  201.                             <soundinterval>
  202.             suspendsoundstatus  "True" or "False" - specifies whether sounds
  203.                     are suspended in the Status View mode.
  204.  
  205.  
  206. CHEAT
  207.  
  208. So, you want to cheat at CyPet? OK, here's what you do:
  209.  
  210. Click Stats and then click Change Name. Enter the new name as "AXE
  211. SOFTWARE, HOW NICE IT IS" (no quotes, all in capitals). Then you can
  212. either:
  213.     - Click Yes for the "good" cheat
  214.     - Click No for the "bad" cheat
  215.     
  216. The "good" cheat makes the pet really healthy, happy, etc. - just as you
  217. would want it to be. The "bad" cheat makes the pet really unhealthy,
  218. unhappy, hungry, underweight, etc. - just the thing if you want a big
  219. challenge. Actually, a rather huge challenge as the pet tends to die instantly.
  220. Have fun...
  221.  
  222. There is also a hidden cheat where you can change each individual setting. I
  223. use it for testing purposes... and I'm not going to tell you what it is :)
  224.  
  225.  
  226. CHANGING THE GRAPHICS & MAKING YOUR OWN ANIMALS
  227.  
  228. This is a different process to the one that you would have used in CyPet 1
  229. (well, you most likely didn't use it at all, but anyway...). As CyPet 2 has
  230. support for multiple animals, it is easier to add your own graphics to CyPet.
  231. All you do is modify your ANIMALS.DAT file - this is what it should look like
  232. after a normal installation of CyPet, without the asterisks and not indented (I
  233. added those so you notice the spaces):
  234.  
  235. *** [ beginning of file ] ***
  236.     ANIMALS.DAT-0001-200
  237.     1
  238.     DEFAULT:
  239.     CYPET01.GIF
  240.     CYPET02.GIF
  241.     CYPET03.GIF
  242.     CYPET04.GIF
  243.     CYPET05.GIF
  244.     CYPET06.GIF
  245.     CYPET07.GIF
  246.     CYPET08.GIF
  247.     CYPET09.GIF
  248.     CYPET10.BMP
  249.     BELCH.WAV
  250.     LAUGH.WAV
  251.     OWCH.WAV
  252.     GIVEFOOD.WAV
  253.     BORING.WAV
  254.     OI.WAV
  255.     HELLO.WAV
  256.     TAPS.WAV
  257.     Old-Style v1.0
  258.     OLD01.GIF
  259.     OLD02.GIF
  260.     OLD03.GIF
  261.     OLD04.GIF
  262.     OLD05.GIF
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275. *** [ END ] ***
  276.  
  277. The space between the "OLD05.GIF" line and the "END" line is VERY important. If
  278. you paste that straight into an ANIMALS.DAT file make sure you include the
  279. space. Note that there is no need to do this anyway, as if you muck up the
  280. ANIMALS.DAT file you can easily delete it and CyPet will restore the file to
  281. the default.
  282.  
  283.  
  284. Here's what it all means, line by line:
  285.  
  286. 1  VERSION HEADER       This should be ANIMALS.DAT-0001-200. Anything else
  287.                         will make CyPet assume an invalid file. Note that CyPet
  288.                         2 Beta Releases 1 and 1a used ANIMALS.DAT-0000-200,
  289.                         which is NOT compatible with this version.
  290.                         
  291. 2  NO. OF ANIMALS       This is the number of animals in addition to the
  292.                         Default - ie number of animals -1.
  293.                         
  294. Next come the animals, in groups of lines in the following order:
  295.     
  296.     1  NAME             For the first pet this should be DEFAULT: and for
  297.                         subsequent animals, the name of the animal that is to
  298.                         be displayed in the drop-down box on the New Pet
  299.                         dialog should be here. In the example, the additional
  300.                         pet is called "Old Style v1.0"
  301.                         
  302.     2  GIF: NORMAL      This is the GIF file that is displayed when the pet is
  303.                         "normal" - ie not showing any emotion/warning.
  304.     
  305.     3  GIF: HUNGRY      GIF to display when the pet is hungry, of course.
  306.     4  GIF: HAPPY
  307.     5  GIF: SAD
  308.     6  GIF: BORED
  309.     
  310.     7  GIF: < CORRECT   The GIF to display in peek-a-boo when the player
  311.                         chooses the left side and is correct.
  312.     8  GIF: > CORRECT
  313.     9  GIF: < INCORRECT
  314.     10 GIF: > INCORRECT
  315.     11 GIF: HIDE-N-SEEK The GIF file to display in the Hide 'n' Seek game. This 
  316.             is the new, extra setting in the Beta Release 2
  317.             ANIMALS.DAT file which is why BR2's file is
  318.             incompatible with the previous versions'.
  319.     
  320.     12 WAV: BELCH       The WAV to play after the pet has been fed.
  321.     13 WAV: LAUGH       This WAV used to be played when you got the correct
  322.                         side in peek-a-boo. However, very recently I changed
  323.                         CyPet so that the music played throughout the game, so
  324.                         this file is not used any more. It will be replaced by
  325.                         something else in the next Beta, probably...
  326.     14 WAV: OWCH        When the pet is injected
  327.     15 WAV: HUNGRY      
  328.     16 WAV: BORED
  329.     17 WAV: RAND1     } These WAVs are played randomly throughout the game -
  330.     18 WAV: RAND2     } the chance of a random sound being played is set
  331.     19 WAV: RAND3     } in the Options dialog.
  332.  
  333.  
  334. Blank lines in any of the above give a short way of using the same file used by
  335. the default pet. For example, leave a blank line in line 17 to use the same
  336. RAND2 WAV file as used by the default animal type. This will work for any
  337. animal other than the first DEFAULT: pet, of course. It is used in the original
  338. ANIMALS.DAT above, hence the blank lines ("Old Style v1.0" uses the same sounds
  339. as the default animal).
  340.  
  341.  
  342. EDITING THE NAMES LIST
  343.  
  344. Simply edit NAMES.DAT to edit the names in the drop-down list box on the "New
  345. Pet" window.
  346.  
  347.  
  348.  
  349.  
  350. Have fun with the above tips!
  351.  
  352. Alex Warren
  353. July 1998